Update CSS nodes documentation
authorCosimo Cecchi <cosimoc@gnome.org>
Mon, 29 Feb 2016 18:43:12 +0000 (10:43 -0800)
committerCosimo Cecchi <cosimoc@gnome.org>
Mon, 29 Feb 2016 18:45:14 +0000 (10:45 -0800)
gtk/gtkscale.c
gtk/gtkscrollbar.c

index 3caecb7037bb4f139c538bdf29cf99fe4d898d7e..ab497463426d03d7370a8a0f2385c5998eb6b9bc 100644 (file)
  * scale[.fine-tune]
  * ├── marks.top
  * │   ├── mark
+ * │   ┊    ├── [label]
+ * │   ┊    ╰── indicator
  * ┊   ┊
  * │   ╰── mark
- * ├── trough
- * │   ├── slider
- * │   ├── [highlight]
- * │   ╰── [fill]
+ * ├── contents
+ * │   ╰── trough
+ * │       ├── slider
+ * │       ├── [highlight]
+ * │       ╰── [fill]
  * ╰── marks.bottom
  *     ├── mark
- *     ┊
+ *     ┊    ├── indicator
+ *     ┊    ╰── [label]
  *     ╰── mark
  * ]|
  *
- * GtkScale has a main CSS node with name scale, and subnodes with names
- * trough and slider.
+ * GtkScale has a main CSS node with name scale and a subnode for its contents,
+ * with subnodes named trough and slider.
  *
  * The main node gets the style class .fine-tune added when the scale is in
  * 'fine-tuning' mode.
  * there is a subnode with name fill below the trough node that is used for
  * rendering the filled in part of the trough.
  *
- * If marks are present, there is a marks subnode before or after the trough
+ * If marks are present, there is a marks subnode before or after the contents
  * node, below which each mark gets a node with name mark. The marks nodes get
  * either the .top or .bottom style class.
+ *
+ * The mark node has a subnode named indicator. If the mark has text, it also
+ * has a subnode named label. When the mark is either above or left of the
+ * scale, the label subnode is the first when present. Otherwise, the indicator
+ * subnode is the first.
  */
 
 
index 0f4ca11291f3272f0af2d5056c5fdbe6d9449eba..27c9c7f701d9de4a4a33492194f25de1d3b343df 100644 (file)
  * # CSS nodes
  *
  * |[<!-- language="plain" -->
- * scrollbar
- * ├── [button.down]
- * ├── [button.up]
- * ├── trough
- * │   ╰── slider
- * ├── [button.down]
- * ╰── [button.up]
+ * scrollbar[.fine-tune]
+ * ╰── contents
+ *     ├── [button.up]
+ *     ├── [button.down]
+ *     ├── trough
+ *     │   ╰── slider
+ *     ├── [button.up]
+ *     ╰── [button.down]
  * ]|
  *
- * GtkScrollbar has a main CSS node with name scrollbar, and subnodes with
- * names trough and slider.
+ * GtkScrollbar has a main CSS node with name scrollbar and a subnode for its
+ * contents, with subnodes named trough and slider.
  *
  * The main node gets the style class .fine-tune added when the scrollbar is
  * in 'fine-tuning' mode.